home *** CD-ROM | disk | FTP | other *** search
/ Suzy B Software 2 / Suzy B Software CD-ROM 2 (1994).iso / adult_ed / alvin / alvin.txt < prev    next >
Text File  |  1995-05-02  |  12KB  |  308 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.    //////////  ALVIN v1.22     REALM Copyright 1993  //////////
  7.                          Created by REALM
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                [1.0] ---- INTRODUCTION
  14.                [1.1] ---- LICENSE AGREEMENT
  15.                [1.2] ---- INSTALLATION
  16.                [1.3] ---- ALVIN a quick overview
  17.  
  18.                [2.0] ---- HOW TO INPUT THE DATA
  19.                [2.1] ---- DECIMAL ENTRY
  20.                [2.2] ---- FRACTION ENTRY
  21.                [2.3] ---- UNIT ENTRY
  22.                [2.4] ---- SELECTING AN INPUT UNIT
  23.                           via THE BUTTONS
  24.  
  25.                [3.0] ---- HOW TO CONTROL OUTPUT
  26.                [3.1] ---- THE DECIMAL - FRACTION BUTTON
  27.               [3.1a] ---- CONTROLLING THE FRACTION
  28.                [3.2] ---- THE NORMAL - UNITS BUTTON
  29.                [3.3] ---- SELECTING AN OUTPUT
  30.                           via THE BUTTONS
  31.  
  32.                [4.0] ---- SHORT TUTORIAL
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40. [1.0] ---- INTRODUCTION
  41.  
  42.      Welcome to Alvin!  Alvin is an ACC/PRG that converts various 
  43. common units into other various units.  While Alvin is not a 
  44. complete conversion program by any means, it does offer some 
  45. interesting features, such as, full support for input and output 
  46. of both fractions and units.  It also runs as an ACC making it 
  47. accessible from inside your favorite programs.  If you have any 
  48. suggestions or bug reports, feel free to contact REALM!  You may 
  49. reach me via GEnie E-Mail address: REALM or via real mail:
  50.  
  51.      REALM
  52.      10504 Easum Rd.
  53.      Louisville KY 40299
  54.  
  55.      Thanks for your support!  Hope this helps out!
  56.  
  57.  
  58. [1.1] ---- LICENSE AGREEMENT
  59.  
  60.      REALM provides this program free of charge to the end user.  
  61. The user may distribute this program freely as long as the 
  62. following files are included:
  63.  
  64.      ALVIN.PRG or ALVIN.ACC
  65.      ALVIN_H.RSC
  66.      ALVIN_L.RSC
  67.  
  68. It may also be included on PD Shareware disks or other developers 
  69. disks provided it is placed in a FREEWARE folder or stated that it 
  70. is provided free of charge.  No funds may be directly charged for 
  71. this product.
  72.  
  73.      This program is copyright 1993 by REALM.  REALM is not 
  74. responsible for any damage occurring from the use or misuse of this 
  75. product.  If the user does not agree to the above terms then 
  76. he/she/it must delete the software.
  77.  
  78.  
  79. [1.2] ---- INSTALLATION
  80.  
  81.      ALVIN runs as both a program and accessory.  In order to use 
  82. as a program change the name to ALVIN.PRG.  In order to use as an 
  83. Accessory change the name to ALVIN.ACC and place on your boot 
  84. drive.  It's important to make sure both ALVIN_H.RSC and 
  85. ALVIN_L.RSC are included in the same directory with ALVIN.  If not 
  86. ALVIN will either not install itself as an Accessory or inform you 
  87. it can't find the RSC's.  ALVIN_L.RSC is only needed if you intend 
  88. to run ALVIN in ST Medium.  ALVIN_H.RSC is required for all other 
  89. resolutions.
  90.  
  91.  
  92. [1.3] ---- ALVIN a quick overview
  93.  
  94.      ALVIN was designed with ease of use in mind.  While it's a 
  95. little confusing on the surface it's really easy to master.  Most 
  96. of the buttons will automatically update the answer so you can 
  97. quickly convert from one unit to another without reentering your 
  98. data.
  99.  
  100.      At the very top of the dialogue screen is the title bar.  You 
  101. may click there to bring up the info box.  Once you have the info 
  102. box you may continue to the quick help screen or exit back to 
  103. ALVIN.
  104.  
  105.      There are only two user entry box's on the ALVIN screen.  The 
  106. first in the upper left hand corner is for entering your data.  
  107. The second is labeled USER: and relates to the fraction precision.
  108.  
  109.      Directly below the input field is a toggle button labeled 
  110. DECIMAL and a button Labeled NORMAL.  The DECIMAL button will 
  111. toggle between DECIMAL and FRACTION.  The NORMAL button will 
  112. toggle between NORMAL and UNITS.  Both buttons control the output 
  113. format of the answer.
  114.  
  115.      Located to the right of the input field is the fraction 
  116. precision controls.  It contains a group of radio buttons that set 
  117. the Denominator of the fraction.
  118.  
  119.      Placed directly below, the above, is the answer field.  The 
  120. answer or an ERROR message will appear in this box, depending on 
  121. your input.
  122.  
  123.      In the lower left hand corner, taking up almost the entire 
  124. area of the dialogue screen, are the input buttons.  These radio 
  125. buttons mark the unit chosen for input.  (See Below for Details)
  126.  
  127.      In the lower right hand corner, almost identical to the input 
  128. buttons, are the output buttons.  These buttons mark the unit 
  129. chosen for output. (See Below for Details)
  130.  
  131.      Located dead center is both the Convert Icon (ressembles 
  132. large arrows) and the EXIT button.  The Convert Icon causes your 
  133. data to be converted, as does the RETURN key.
  134.  
  135.  
  136. [2.0] ----  HOW TO INPUT THE DATA
  137.  
  138.      ALVIN automatically accepts several types of input.  You can 
  139. enter a straight decimal, a fraction or use the unit extenders.  
  140. ALVIN only recognizes negative numbers for the temperature units.
  141.  
  142.  
  143. [2.1] ---- DECIMAL ENTRY
  144.  
  145.      Entering a decimal is straight forward.
  146. ( For Example: 1254.3658 )
  147.  
  148.  
  149. [2.2] ---- FRACTION ENTRY
  150.  
  151.      Fractions must be entered exactly in the way shown or a wrong 
  152. answer will result. ( For Example: 12-1/2 )  Take note there are 
  153. no spaces and the hyphen must separate the whole number from the 
  154. fraction.  The fraction itself must be divided using the "/" 
  155. symbol.
  156.  
  157.  
  158. [2.3] ---- UNIT ENTRY
  159.  
  160.      Unit entry is one of the more advanced features of ALVIN.  It 
  161. allows the input to be typed in units.  It's important the units 
  162. are entered in descending order according to size.  Check the 
  163. abbreviation list below for a full explanation.
  164. ( For example: 1ml 7yd 12ft 4 )
  165.  
  166.      Note the last unit of Inch's is left off.  ALVIN always 
  167. assumes the last unit to be the smallest. If you wish to type "in" 
  168. it won't interfere nor will it hurt to leave out the spaces.
  169. ( For example: 1ml7yd12ft4in ) is also correct.
  170.  
  171.           Abbreviations in descending order:
  172.  
  173.                ml - Mile           km - Kilometer
  174.                yd - Yard           me - Meter
  175.                ft - Feet           cm - Centimeter
  176.  
  177.                et - English Ton    mt - Metric Ton
  178.                lb - Pound          kg - Kilogram
  179.  
  180.                gal - Gallon        dl - Dekaliter
  181.                qt - Quart
  182.  
  183.      You may leave out units when entering but you may not enter 
  184. in the wrong order.  ( 4yd 6-1/2 ) is considered, 4 yards, 6-1/2 
  185. inches.  ( 4yd 6ml 2) is considered 4 yards, 6 inches not 4 yards, 
  186. 6 miles, 2 inches.  It will result in a wrong answer.
  187.  
  188.      The case (upper or lower) of the abbreviation is unimportant 
  189. but the spelling must be correct.  I tried to use the correct 
  190. abbreviations but some had to be altered for the programs search 
  191. to work properly.  Meters had to be changed to "me" instead of "m" 
  192. for example.  The abbreviations are listed in the programs help 
  193. screen for easy reference.
  194.  
  195.  
  196. [2.4] ---- SELECTING AN INPUT UNIT via THE BUTTONS
  197.  
  198.      The input unit is defined by the group of buttons in the 
  199. lower left hand box.  ( For example: INCH, FEET, YARD, Etc...).  
  200. When you click on a new unit the answer will automatically be 
  201. updated to that unit.  If you select FEET then your input data is 
  202. considered to be in feet.  If you select OUNCE then your input 
  203. data is considered to be ounces.  Simply select the unit your 
  204. entering.
  205.  
  206.      When entering in units (EX: 12ft 4in) the buttons will be 
  207. ignored.  If however you are in a section of non compatible units 
  208. the answer will ignore the entry.  For instance if you have OUNCES 
  209. selected and type (EX: 12ft 4in) everything after 12 will be 
  210. ignored.  This is due basically because you can't convert feet 
  211. into pounds.
  212.  
  213.  
  214. [3.0] ---- HOW TO CONTROL THE OUTPUT
  215.  
  216.      The output is controlled buy several factors.  It can be in 
  217. Decimal form, fraction from, unit form or a combination of the 
  218. above.  You also have complete control over fractions up to 1/999.  
  219. When using UNITS some rounding errors may occur.  I've attempted 
  220. to round the answers correctly to get the results needed.  For 
  221. example, 1-1/3 feet does read 1ft 4in even though 1/3 is (.3333-) 
  222. of a foot.  If you take 12 and divide by (.3333-) and you get (1ft 
  223. 3.9999in) so the answer is rounded to give a closer answer.
  224.  
  225.  
  226. [3.1] ---- THE DECIMAL - FRACTION BUTTON
  227.  
  228.      Selecting this button will instantly change the answer from 
  229. "DECIMAL" form to a "FRACTION" form. ( For example: 12.5 will 
  230. become 12-1/2 ).
  231.  
  232.  
  233.      [3.1a] ---- CONTROLLING THE FRACTION
  234.      
  235.           The Fractions denominator may be controlled by selecting 
  236.      one of the choices next to the input field.  Directly left of 
  237.      the field is a group of 6 numbers positioned over a long 
  238.      "user" button.  Each one of those buttons represents the 
  239.      denominator of the fraction.  For example:  2 would round all 
  240.      fractions to the nearest 1/2, 4 to the nearest 1/4, 8 to the 
  241.      nearest 1/8, 16 to the nearest 1/16, 32 to the nearest 1/32 
  242.      and 64 to the nearest 1/64.  After the fraction is rounded it 
  243.      will be reduced so even if you have "32" selected your answer 
  244.      may still be 1/2.
  245.  
  246.           The "user" button allows the user to enter any 
  247.      denominator from 1 to 999.  If you wish to have an answer to 
  248.      the nearest 1/3 simply enter 3 in the "USER:" field, then 
  249.      select the "user" button.  All fractions are still reduced.
  250.  
  251.  
  252. [3.2] ---- THE NORMAL - UNITS BUTTON
  253.  
  254.      Selecting this button will instantly change your answer from 
  255. the "NORMAL" form to the "UNITS" form.  (For Example: 12.5 may 
  256. become 12-1/2in).  The amount of units involved are controlled by 
  257. the output buttons.  For instance, if you have "FEET" selected as 
  258. your output unit the answer will be given as "ft" then "in".  If 
  259. you have "KILOMETERS" selected, your answer will be given as 
  260. "km","m","cm" then "mm".
  261.  
  262.  
  263. [3.3] ---- SELECTING AN OUTPUT UNIT via THE BUTTONs
  264.  
  265.      The output unit is defined by the group of buttons in the 
  266. lower right hand box.  ( For example: INCH, FEET, YARD, Etc...).  
  267. When you click on a new unit the answer will automatically be 
  268. updated to that unit.  If you select FEET then your output data is 
  269. considered to be in feet.  If you select OUNCE then your output 
  270. data is considered to be OUNCEs.  Simply select the unit you would 
  271. like for your answer.
  272.  
  273.  
  274. [4.0] ---- SHORT TUTORIAL
  275.  
  276.      For this tutorial will assume you have ALVIN installed an 
  277. running.  If you've already destroyed the programs default 
  278. settings you may want to start over so the defaults are set 
  279. correctly.
  280.  
  281.      First lets start by entering 145-1/2.  You'll notice INCH 
  282. is selected in the input area.  This means we have entered 145-1/2 
  283. inch's.  In the output area, FEET is selected, so hit the RETURN 
  284. key now to convert 145-1/2 inch's to 12.125 feet.  Next lets try 
  285. yards by clicking on the YARD button just below FEET.  You can 
  286. see it's 4.0417 yards.  This is the basic method of converting 
  287. from one unit to another.
  288.  
  289.      Now lets leave that alone and click on the DECIMAL button.  
  290. It'll change to FRACTION and our answer will become 4-1/32 yards.  
  291. Just for fun lets change our fraction to 3rd's.  Click on the 
  292. USER: field and enter 3 without hitting RETURN.  Now choose the 
  293. user button in the fraction area.  Our answer will change to 4.  
  294. This is caused by the answer being to small to create an entire 
  295. 1/3 fraction so it becomes just the whole number.  Lets try 
  296. something a little more precise like 256.  This time after 
  297. entering a denominator in the USER: field, click on the large 
  298. arrows icon to activate the entry.  Now we have 4-11/256 yards.
  299.  
  300.      Next click on the NORMAL button.  This will toggle to UNITS 
  301. and our answer will become 4yd 0ft 1-1/2in.  Thats 4 yards, 0 
  302. feet, 1-1/2 inch's.  If you would like to know what that is in 
  303. feet, simply click on the FEET button directly above yards.  Now 
  304. the answer will be 12ft 1-1/2in.
  305.  
  306.      Well... thats about all there is too it.  Hope this will help 
  307. fill your conversion needs!
  308.